If you have a VN Exclusive proxy, you can request a new exit IP by calling our Change-IP API. Only the exit IP changes; keep using the same host:port:username:password.
1 What you need
- Your proxy username and password (the same as in
host:port:username:password). - The API base URL:
https://proxy_api.hstockplus.com
2 API details
| Method | POST |
|---|---|
| Path | /api/v1/proxy/change-ip |
| Authentication | HTTP Basic (proxy username and password) |
| Response | JSON: {"success": true|false, "message"?: string, "error"?: string} |
3 cURL command
Use https://proxy_api.hstockplus.com as the API base and your proxy username and password:
curl -X POST "https://proxy_api.hstockplus.com/api/v1/proxy/change-ip" -u "YOUR_PROXY_USERNAME:YOUR_PROXY_PASSWORD"
Example:
curl -X POST "https://proxy_api.hstockplus.com/api/v1/proxy/change-ip" -u "prx_1d57_80cc1b:M8mHQuZA"
4 Success and error codes
| Result | HTTP | Meaning |
|---|---|---|
| Success | 200 | {"success":true,"message":"Change-IP request sent"}. Your next requests through the proxy will use the new IP. |
| Auth failed | 401 | Missing or invalid Basic auth. Use your proxy username and password in the Authorization header. |
| Not eligible | 400 | This account is not a VN exclusive proxy, or it has no key assigned. Check with your provider. |
| Order not found | 404 | Order was deleted or does not exist. Contact support. |
| Wait before retry | 429 | Too many change-IP requests. Response error gives the message (e.g. "Please wait 171 seconds before requesting a new proxy."). Use the Retry-After response header (seconds) before calling again. |
| Upstream busy | 502 | No new IP available at the moment. Try again later. |
| Service error | 503 | Upstream or internal error. Check the error field in the response body. |
| Server error | 500 | Unexpected server error. Check error in the response; retry or contact support. |
Note: You do not change your proxy host or port. Keep using the same
host:port:username:password; only the exit IP is updated after a successful change-IP call.
This guide applies to VN Exclusive proxy accounts. For other proxy types or issues, contact your provider.